home *** CD-ROM | disk | FTP | other *** search
/ Merciful 2 / Merciful - Disc 2.iso / software / f / freakbootv2.0.lha / FreakBootV2.0 / FreakBoot.doc < prev    next >
Text File  |  1980-06-28  |  15KB  |  293 lines
  1.  
  2. ========================================================================
  3.                          *** W A R N I N G ***
  4. ========================================================================
  5.  
  6. I/We/Everybody  and his dog accepts NO responsibility for any loss of or
  7. damage to any data, personal features, vital signs, war, acts of God (or
  8. Satan), as a direct or indirect result of the use or misuse of this neat
  9. and skillo program.  In short, you're on your own, son!
  10.  
  11. ========================================================================
  12.   ________________________  ________   _______  ____    ____  _________
  13.  |        /__  \      /__ \|   /   /---\____  \/    \--/    \/        /
  14.  |     __/  |  /   __/  |  \  /   /     |  |  /      \/      \__   __/|
  15.  |     _/   _  \   _/\  _   \     \     |     \ /\    \ /\    \|   |  |
  16.  |     ||   |   \     \ |    \\    \    |  |   \\/    / \/    /|   |  |
  17.  l_____|l___l_  /___  /_l__  /_\_  /    l____  /___  /\____  / l_  j  |
  18.  +------------\/----\/-----\/----\/----------\/----\/------\/----\/---+
  19.  
  20.                   Version 2.60 - Release Date: 9.4.95
  21.                   ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  22.  
  23.               ===========================================
  24.                         MAJOR CHANGE WARNING!!!
  25.               ===========================================
  26.               This version of FreakBoot is not compatible
  27.               with the config files that you use with any
  28.               older versions as extra data catagories are
  29.               now included - read this doc very carefully
  30.               and make sure you understand!!
  31.                                                 Freak/NFA
  32.               ===========================================
  33.  
  34. F*ck  knows  why  you'd ever want to use this, but Pex/QuI says it's the
  35. coolest  thing since my fridge, Deck the Ripper/NFA insists on seeing it
  36. after claiming my previous setup (FreakBoot v1.0) was "very tidy", and I
  37. AM just a LITTLE bit proud of it myself, so...
  38.  
  39.                             What does it do?
  40.                             ~~~~~~~~~~~~~~~~
  41. Well,  it  wastes  loads  of  RAM,  looks very pretty, and allows you to
  42. quickly  and easily boot your system into a number of configurations, oh
  43. and it plays Soundtracker Mods and samples too...
  44.  
  45.                          What are you on about?
  46.                          ~~~~~~~~~~~~~~~~~~~~~~
  47. FreakBoot  v2.0 was  basically a menu that was written for my A1200 with
  48. 2Mb  CHIP  and  4Mb FAST Ram, there were occasions where I would want to
  49. boot  with a certain configuration, like straight into a game instead of
  50. going  through  Workbench all the time, or maybe I'd want to boot PPaint
  51. with  the maximum amount of CHIP ram and all the PC drivers mounted, get
  52. the idea?
  53.  
  54. The  original idea came from Video/iNDi (although he doesn't know it), I
  55. was  at  his  house  watching him on his PC, and he had this little menu
  56. come  up  -  just a few lines of text on the screen, pick 1 to 4 and all
  57. that,  nothing  brilliant  - and at the time I dismissed it as necessary
  58. only on the (koff koff) PC, as he ONLY (!) had 4Mb of RAM and, PCs being
  59. so shite and all, needed to use varying setups for certain things.
  60.  
  61. HOWEVER!! Murphys law of computers number 4872 states that "The faster a
  62. machine gets,  the  more impatient the user will become when waiting for
  63. something to load", and would you bloody believe it?  It's True!
  64.  
  65.                           How do I Install it?
  66.                           ~~~~~~~~~~~~~~~~~~~~
  67. NOTE!!!  Before you do ANYTHING you should copy your Startup-sequence to
  68. a  safe  place  just  in  case you're not as handy with the Shell as you
  69. should be!
  70.  
  71. FB2  simply  executes  a  script file depending on your menu choice, you
  72. make a copy of your original HD startup-sequence (call it S:Full.boot or
  73. something) and create a new one thus:
  74.  
  75.                             Assign ENV: Ram:
  76.                             Run >Nil: C:FreakBoot
  77.                             Endcli >Nil:
  78.  
  79. You also need a config file, and it's best to get this sorted before you
  80. rename your startup-sequence.  Basically it consists of plain ASCII text
  81. lines  comprising  your  keyboard shorcut, menu text and the name of the
  82. script  file  to be executed, seperated by a "|" character.  Blank likes
  83. should be represented with " | | " (space-"|"-space-"|"-space) otherwise
  84. you'll get a funky error and the menu will quit.
  85.  
  86. A typical configuration may look something like this:
  87.  
  88.                     F|Full AGA Workbench|Full.boot
  89.                      | | 
  90.                     M|Mini Workbench|Mini.boot
  91.                     S|Non-AGA Shell|Shell.boot
  92.                      | | 
  93.                     D|DPaint IV|DPaint.boot
  94.                     K|Kickstart 1.3|Kick13.boot
  95.  
  96. This  file  must  be  saved in your assigned S:  directory and should be
  97. called "FreakBoot.cfg", when you run the program it will search for this
  98. file  and  strip  it  down  into a presentable menu.  Note that versions
  99. earlier  than v2.60 loaded a file called "NFA_Boot.config" which did not
  100. contain  the  keyboard  shortcuts.   I have used a different filename so
  101. that you don't have to over-write your existing data.
  102.  
  103. To update your existing file to v2.60 simply load it up into your editor
  104. and add " |" (Space-"|") to the start of every line, you can insert your
  105. keyboard shortcuts instead of the space if you want them, then save this
  106. new file as "S:FreakBoot.cfg" and copy the new executable over the older
  107. one, reset your pooeter, and away you go.
  108.  
  109. Keyboard shortcuts are not necessary, but if you do not want one for any
  110. particular line you must still pad it out with a space character.  These
  111. keys may be entered in Upper case if you wish, but will be displayed and
  112. accepted in lower case, so ensure you do not have the CAPS LOCK light on
  113. otherwise  your keypresses will not be recognised.  If a keyboard short-
  114. cut is assign to an item then is will be displayed on the screen.
  115.  
  116. You  can  give  the filenames an optional path if you want, but remember
  117. that  you  will  NOT  be  CD'd to that directory.  The "Execute" command
  118. automatically searched the S:  dir first so if your filenames don't have
  119. a path (like those above) then it'll hunt here for them.
  120.  
  121. Obviously you need the Execute command in your C:  dir, and also the Run
  122. command  unless  (in Kickstart 2.0 and greater) it's in ROM already as a
  123. resident command.
  124.                            Did you say Music?
  125.                            ~~~~~~~~~~~~~~~~~~
  126. Yup,  FB2  will check the S:  directory for a Soundtracker module called
  127. "Boot.mod"  and  will  load and play it if it's there.  This module must
  128. not  be  Powerpacked,  nor  must it use any fancy timing tricks, because
  129. AMOS  doesn't like such things, so if you ripped that funky mod from the
  130. end of the Limbo "H.T.K.H" demo, sorry but it won't work!
  131.  
  132. FB2  will  now  play  mono 8SVX samples, if you save one in your S:  dir
  133. with  the  filename "Boot.sam" it will be played, if you save it as file
  134. "Boot.loop"  then  it  will  (surprise!)  loop, make sure it sounds okay
  135. before  you  use it!  Note that samples take precedence over modules, if
  136. you have both a sample AND a mod saved then only the sample will play.
  137.  
  138. For  your  information,  the biggest sample I've played so far was "Meet
  139. the  Flintstones", and a CHIP-Stuffing 1.24Mb it was too!  Pex/QuI use a
  140. massive 1.05Mb sample on a standard A1200 with no problems.
  141.  
  142.                        *** NEW FEATURE ADDED ***
  143.                        ~~~~~~~~~~~~~~~~~~~~~~~~~
  144. From v2.51 the menu will allow you to play a sample on exit as well, not
  145. including  the reset of course!  Save your mono 8SVX sample as a file in
  146. your S: directory (as usual!) called "Boot.exit" and all sound will stop
  147. for this sample to play.  Note that I have specifically created the pair
  148. of samples "Boot.loop" and "Boot.exit" in this archive to go together to
  149. give you some idea of how you can use this - enjoy!
  150.  
  151.                             Any Limitations?
  152.                             ~~~~~~~~~~~~~~~~
  153. Hmmm,  well the program was actually produced for NFA and so it says NFA
  154. all over it.  I don't mind if non-NFA people use it and I might change a
  155. few  bits  in  the future to make it more configurable, but then again I
  156. may not, let me know if you want anything doing!
  157.  
  158. As I said before it also wastes RAM, although I'm sure the Amiga's OS is
  159. efficient enough to return the RAM to you as quickly as you can quit the
  160. program.   Don't forget that I use it on a 6Mb A1200 so I have plenty of
  161. RAM  in  which  to  run  it  AND a hee-uge module without worrying about
  162. fragmented memory, it may not be the same for you!
  163.  
  164.                        *** NEW FEATURE ADDED ***
  165.                        ~~~~~~~~~~~~~~~~~~~~~~~~~
  166. From  v2.5 if you have a RAW Font file in your S:  directory and call it
  167. "Boot.font"  then  it  will be loaded and used.  These fonts are getting
  168. more and more popular, I've included one for you to use...
  169.  
  170.                             In this Archive:
  171.                             ~~~~~~~~~~~~~~~~
  172.           ----------------------------------------------------
  173.           File                What's that?              Len(b)
  174.           ----------------------------------------------------
  175.           Boot.exit           A quit sample.             15018
  176.           Boot.font           An optional RAW font         768
  177.           Boot.loop           A Sample I made up.        27612
  178.           Boot.mod            A nice module               7918
  179.           FreakBoot           Program to go in C:        82160
  180.           FreakBoot.cfg       Config file to go in S:       91
  181.           FreakBoot.doc       This doc file              14920
  182.           ----------------------------------------------------
  183.  
  184.                           Miscellaneous Infos:
  185.                           ~~~~~~~~~~~~~~~~~~~~
  186. Freak Boot v2.0/NFA_Boot was  written in  AMOS Professional although the
  187. source is completely 1.35 compatible, no machine code was used but I did
  188. crash  my  pooter a couple of times getting the parallax effect working,
  189. serves me right for "Loke"ing where I'm not wanted I suppose...
  190.  
  191. *NOTE*  Assembler  HAS  been used in v2.5 and I doubt very much that the
  192. source code is still 1.35 compatible now I think about it...
  193.  
  194. The  font supplied is the MicroKnight font - I don't know who created it
  195. but it looks kin' SMART!!
  196.  
  197. The module is "Tots TV" by Neø from the Citv demo - excellent stuff!
  198.  
  199. The samples "Boot.loop" and "Boot.exit" supplied in the archive are ones
  200. I made up from bits of "Alien Breed Tower Assault CD" and "Frontier" and
  201. are to illustrate how matching samples can make a difference.
  202.  
  203. AMOS, AMOS Pro, and the AMOS Pro Compiler are © Europress Software.
  204.  
  205.            Freak Boot v2.60 has been tested on the following:
  206.  
  207.      A1200 - 0Mb Fast RAM, 20Mb HD, 1 External (CHIP Availability)
  208.      A1200 - 4Mb Fast RAM, 40Mb HD, 1 External (FAST Compatibility)
  209.  
  210.                                 History:
  211.                                 ~~~~~~~~
  212. v2.0                -       Original Re-Write from v1.0
  213.  
  214. v2.1  (15.11.94)    -       Pex decides that the logo on the slower
  215.                             bitplane should be made smaller to give a
  216.                             more 3D effect, I agreed, plus tiny Palette
  217.                             change done as well, slower plane is now
  218.                             a bit darker
  219.                             Cursor Key control added, you can now use
  220.                             c/up & c/down to move and return to select.
  221.  
  222. v2.2  (15.11.94)    -       Added sample playing as an option to mods.
  223.  
  224. v2.3  (20.11.94)    -       Fixed a bug in the sample-replay routine
  225.                             that threw a wobbler on hee-uge samples!
  226.  
  227. v2.4  (29.11.94)    -       Joystick control added for lazy b*st*rds,
  228.                             use up, down and fire to select.
  229.  
  230. v2.41 (02.12.94)    -       Toby Ted added, just wait a minute!
  231.  
  232. v2.42 (23.12.94)    -       Now the Escape key actually DOES some-
  233.                             thing!  It will call the Exec ColdReBoot()
  234.                             function so you can boot from floppy disk
  235.                             more easily.
  236.  
  237. v2.5  (23.2.95)     -       BIG Changes!  Changed mouse pointer,
  238.                             You can now have a RAW font file,
  239.                             Changed the Smiley logo,
  240.                             Removed Text Shadow,
  241.                             Version Number added on-screen.
  242.  
  243. v2.51 (24.2.95)     -       Changed logo for a better one,
  244.                             Added Quit sample + calculated wait,
  245.                             Removed Toby Ted, he retired!
  246.                             Fixed a bug in the parallax routine,
  247.                             Supplied samples amplified slightly.
  248.  
  249. v2.52 (25.2.95)     -       Minor bug fixed in Exit Sample routine.
  250.                             (Small but Hi-Rate samples finished early).
  251.  
  252. v2.60 (9.4.95)      -       Added Keyboard Shortcuts, suggested by a
  253.                             scene dude, >Bad Monkey<.
  254.  
  255.       ===========================================================
  256.                       To contact NFA - Read on!!!
  257.       ===========================================================
  258. _______                ___                            _____
  259. \      \____________  |   |_____________________     /     \______________
  260.  \____  \___/ _____/  |   |   |___ \_____  \___ \   /       \    \       /
  261.   |  |  /   \ \    \  |   |   |  |  \   |  /  |  \ /         \    \   __/
  262.   |     \    \ \    \ |       |  _   \  _  \  |   \\   /\     \ _  \  _/\
  263.   |  |   \    \     / |   |   |  |    \ |   \      \\  \/     / |   \    \
  264.   l____  /__  /__  /  l___|   |__l__  /_l_  /____  / \_____  /__l_  /__  /
  265.  +-----\/---\/---\/-------l___|-----\/----\/-----\/--------\/-----\/---\/-+
  266.  
  267.               NFA WHQ-BBS - Sysop: Deck the Ripper of NFA
  268.     A4030 6mb ram 68882 fpu 50mhz, 600mb HD, with fido netmail point
  269.        _______ 
  270.     .=(   _   )    __   _  _  ____   ____  ____ ____ _  ____ _  __
  271.     § `-j¯_¯l-'   /  \ / )/ )/ __/  (__  )/ __// __// )/ __// )/  \
  272.     §  / (_) \   / / // // // . /  /¯___// . // . // // . // // / /
  273.     `°(_______)  \__/(_/(_/ \__/  (____/ \__/ \__/(_/ \__/(_/ \__/
  274.  
  275.       ===========================================================
  276.  
  277.      You can contact NFA at either of the following addresses too:
  278.  
  279.                 N.F.A.                      N.F.A.
  280.                 P.O.Box 42,                 P.O.Box 323,
  281.                 Grimsby,            and     Campbell Street,
  282.                 South Humberside.           Leicester.
  283.                 DN33 1RY                    LE1 5XP
  284.  
  285. Coders,  artists  and musicians wanting to join should write to Freak of
  286. NFA at the Grimsby address.
  287.  
  288. Modem-traders,  Mail-traders  and BBSs who want to either join or spread
  289. wares for us should write to Deck the Ripper at the Leicester address or
  290. log on to the Big Hard One BBS on 0116 2661610
  291.  
  292. ========================================================================
  293.